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COMX 35 - 


General Technical Information 


Power : unregualted DC 9V from external 4.5VA AC/DC adaptor current 
consumption £ 200 mA 


Crystal Oscillation frequencies : 


PAL models == _ 8.867236 MHZ 
5.626 MHZ 
NTSC models == 7.15909 MHZ 
5.67 MHZ 


Processor clock frequencies : 
PAL models == 2.813 MHZ 
NTSC models == 2.835 MHZ 


Processor bus cycle frequencies : 
PAL models == 351.6 KHZ 
NTSC models = — 354.4 KHZ 


Memory cycle frequencies : 
PAL models —=— 351.6 KHZ 
NTSC models =—— 354.4 KHZ 


> 


RF TV output frequencies : 
UHF == 591.25 MHZ (1mV) 
VHF —— 61.25 MHZ (1mV) 


Cassette 1/0 baud rate (frequencies) ~ 2 KHZ 


Processor : 1802A 

Date transfer rate : 351.6 bytes/sec maximum 

Memory capacity : 35K bytes (standard) 
67K bytes (expanded) 

Audio Speaker Output : & watt 


General 


Circuit composition : Resistor, capacitor, inductor, diode and IC 
(majorty CMOS; others NMOS, TTL and linear) 


Memory composition : 16K bytes NMOS ROM 
3-4 kilo bytes CMOS static RAM 
32K bytes NMOS Dynamic RAM 


Operational Technical Information 


Dynamic memory refresh : by cycle steal DMA 

Keyboard scanning : by dedicated self-scanning keyboard encoder. 
Screen scanning : by video display controller. 

Screen updating : buffer, interrupt driven. 

Keyboard input >: pseudo-interrupt driven. 

Audio output : hardware generated. 


Cassette 1/0 >: software driven. 
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Introduction 


The hardware description of COMX 35 is divided into 10 sections 
and the operating principles of each subsystem is explained in 
sufficient details. Readers with fundamental understanding of 
any microprocessor should be able to understand the operating 

_ principle of the COMX 35 after reading this. 


All service personnel should read this note before attempting to 
repair a COMX 35 computer. 


Power Supply Unit 


The COMX 35 comes with a wall-mounted AC adaptor which is rated 
at DC 9V(or 12V), 500MA (or 800mA). Power is fed to the COMX 
35 through a standard DC power Plug. Polarity is "centre-positive". 


The output from the AC adaptor is fed to the audio amplifier IC 
and "pin C" of the expansion socket. All digital circuitries are 
operated under +5V DC power sourced by a 3-pin IC regulator. The 
DC adaptor supplies rectified unregulated DC input power to the 
regulator which gives a regulated 5V Output. For this regulator 
to maintain a stable 5V output, the input must be kept at 7V or 
higher at all times 
input 


9-12V DC Output 5V 
Regulator 








C29 


The two capacitors (c29,c32) are used to maintain the stability 
of the regulator IC. Unwanted parasitic Output oscillation MAY 
result if these two capacitors are faulty. 


NOTE : The AC adaptor must be plugged firmly into a wall socket. 
A loose connection WILL result in momentary (eg a few 
millisecond) open circuit and loss of power supply. This 
is the most common cause of error in the computer's operation. 


Power~line noise generated by some home appliances (e.g. motor, hair 
dryer, air-conditioner during switch on) can also cause error in the 
computer's operation. Try not to plug the AC adaptor into the SAME 
power line shared by these home appliances. If problem still exist, 
install noise-filter in between the wall outlet and the AC adaptor. 


AC 
OUTLET 















NOISE 
FILTER 


These filter can provide 30-50 dB attenuation to noise in 
frequency range of alout 100 KHz to 30 MHz. In Hong Kong, 
a 200V, 3A line filter is retailed at about USS$4.00 - USS5.00. 


This is the price of a bare unit, i.e. without sockets, casing, 
etc: 


Audio Amplifier 


The audio section consists of one LM386 amplifier IC. Its input 
section consists of 3 resistors, R25-R27. This section determines 
the gain factor of the amplifier. Power is connected to Pin 6 and 
is directly supplied by the AC adaptor. Pin 5 is the output pin 
and should stay at half the supply voltage when there is no input 
signal. C24 and C25 are used to eliminate parasitic oscillation. 
The capacitor connected to pin 7 eliminate 50/60 Hz HUM induced 


by power supply ripple. 


R30 





4. Reset Circuit 


This circuit is used to generate a Sharp reset pulse at a delayed 
period after power up. R1 and Cl provide the necessary delay. 

C2 is used to speed up the "zero to one" transition and provide 

a sharp, glitch-free output. 
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Keyboard Encoder 


COMX 35 use a matrix keyboard and is scanned by the hardware 
keyboard encoder (U4). U4 is clocked by TPB (pin 34) and will 
give a low output on DA (pin 33) line after a key is pressed. 
This is used to tall the CPU that a key has been pressed. The 
CPU then read this key with an "INPUT 3" instruction and a low 


‘is generated on CS1, pin 2] during the read process. RPT (pin 35) 


is used for AUTO REPEAT function. R31 and C14 is the hardware 
debounce timing circuit. The capacitor is discharged on each key 
press. The keyboard encoder is checked (by the interrupt routine) 
after the completion of each TV frame (1/50 sec in PAL mode, 1/60 
sec in NTSC mode). 


PAL/NTSC Selection 


The COMX 35 computer will automatically select itself to be operated 
in PAL or NTSC scanning modes depending on the polarity of CR2 and 
Pin 32 of Ul. 

In PAL mode, the two horizontal lines in the COMX sign (appears after 
power-up or reset) will become GREEN. In NTSC mode, they become 
YELLOW. 

Pin 39 of CDP1870 should be HIGH for PAL mode. It Should be LOW for 
NTSC mode. The system parameter stored at location 4I1CA (HEX) will 
be equal to 9 in PAL mode. It will be equal to 8 in NTSC mode. 


Cassette Interface : 


The cassette output circuit consists of one section of U30 and its 
associated voltage divider. This circuit round the corners of square 
wave and attenuates it to provide a level suitable for feeding into 
the M/C input of an ordinary cassette recorder. 

The cassette input section is a wave-shaping circuit; it derives a 
square wave signal from the analogue signal provided by an or- 
dinary cassette recorder. It expects an input signal egual to or 
higher than 3V (peak-to-peak). 

If C36 is open-circuited, the error rate of cassette Playback will 

be increased. 


Microprocessor and Associated Circuit 
eee ve eee ei curt 


This is the heart and "master" of the COMX 35 computer; all other 
devices are under its control to perform various functions. 


The various pin of the CPU can be functionally grouped as shown 
in the diagram. 
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MAO ~- MA7 


CONTROL 
INPUTS 


I/O 
REQUEST 
INPUTS 


MEMORY, I/0 
TIMING 
OUTPUTS 


17/0 SCI 
OUTPUT BUSO- BUS7 


DATA BUS 





FUNCTIONS OF CPU PINS 


8.1 Instruction Execution Sequence 


In order to execute a machine language instruction, the 
CPU (CDP1802A) has to perform the following steps : 


(a) 


(b) 


(c) 
(d) 


(e) 


(f) 


(g) 


(h) 


Send out the higher 8 bits address of the program 
counter through the multiplexed address bus (MAG to 
MA7) 


When the higher address (A8 to Al5) bits have become 
stable on the MAY to MA7 lines, a HIGH Pulse is sent 
on TPA line.. This pulse will clock the A8 to Al5 
into address latches (U13, U9). 


MRD line become LOW to indicate a memory READ operation. 


The CPU then outputs the lower address (AZ to A7) through 
the multiplexed address lines (MAQ@ to MA7). 


External address decoding circuit will detect whether the 
address range falls into the address range of a particular 
IC (e.g ROM,U21). The particular IC will be enabled if the 
address matches. 


The selected (address matched) IC will then send out data 
into the data bus of the CPU. 


The data is strobled into the CPU during the falling edge 
of TPB (timing pulse B). 


The CPU will then decode the machine instruction represented 
by the op-code just latched in and perform various task as 
instructed. 
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MEMORY READ OPERATION 


Having explain the basic operation of the CPU, we can then proceed 
to discuss the necessary conditions that must be satified before 
the CPU can function : 


(a) Obviously, the CPU must have +5V power and clock signal. 


(b) Clear, wait, DMA IN, DMA eut and interrupt must be in normal 
States. 


(c) The data bus must be clear from faults. No data line can be 
short-circuited to positive power supply or ground. They 
must not be short-circuited to other signal lines as well. 
The CPU will read in a wrong "op-code" if the data lines 
has fault(s). The CPU will not perform properly since it 
will receive "WRONG INSTRUCTIONS". 


(d) The MRD line must be free from fault. 


(e) The lower address line must be free from faults. 
Sometime, the CPU can still execute a short program when a high 
address line is short-circuited to ground. The power-up routine 
is specially written so that all or part of it will execute 
correctly even when there exists some minor circuit faults. 


This routine also has build-in diagnostic functions. It will give 
useful indication as regard to the nature of fault of the COMX 35 


computer. 


Video Interface System (VIS) 


This is the video and sound generating system. Moreover, it also 
generates several essential timing pulses for various parts of the 
COMX 35 computer. 

The dot crystal (YZ) generate the basic timing signal for the whole 
COMX 35 computer. It is used to derive all. timing signals (e.g 
horizontal and vertical sync.) in the TV signal. The dot crystal 
oscillates at about 5.6 MHZ, this signal is divided by 2 and outputs 
through pin 38 of CDP1870. This is used to clock the CPU and derive 
all timing pulses for memory accesses and I/O accesses. 

Another important signal appears at pin 1; it will be ‘LOW on-each 
"display time" when the CRT controller has been programmed in on- 
state. This signal (50Hz for PAL, 60 Hz for NTSC mode) is used 

to drive the interrupt circuit and is essential for normal operation 
of a COMX 35, 


Video Interface System (VIS) 


U7 and Ull are "page memory" which stores the ASCII code for each 
character position on the screen. This memory IC is 1K x 4 bit 
and two IC form 1K x 8 bit system. The screen has 960 character 
position which corresponds to 960 byte in this two ICs. Putting 

a character on TV screen is done by writing the ASCII code of that 
character into this "page memory". 

PMSEL and PMWR of CDP1269 are internally decoded to response to 
memory access in the page memory address region (i.e F800 (HEX) 

to FBBF (HEX)). 

U6 is called "Character memory" which store the bit-by-bit 
character definition of each displayable character. This memory 
is also called "Character generator". Most computer store their 
Character bit pattern in ROM and is not user changable. The 

COMX 35 use RAM to store the character definition. A default 
character set is copied into these character definition R2M by the 
RESET routine. User can redefine them by the BASIC "SHAPE" command 
at anytime he wants. 


Ul14(2) and U8 are bus seperators which will route the CPU data bus 
to the VIS subsystem during "write access" to the page memory 

(U7, Ull). A HIGH pulse will appear at PMSEL (pin 39, CDP1869) 
during the access operation. 


9.1 Writing to Page Memory (U7, U11) . 
dae Oe ACT Ve, 


The microprocessor address bus is decoded and fed to the address 
Input of U7 and Ull. CPU data are gated through U14(2) and U8 

to reach the data input of the memory IC. Write pulse is provided 
through the PMWR pin of the CDP1869. 






CPU data bus 
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CDP 1860 


CPU ADDRESS BUS 





9.2 Writing To Character Definition RAM (U6) 
a EE ESI ETON RAM (U6). 


Writing to character definition RAM is a complicate task and 
it involves a lot of intermediate steps. The write procedure 
is outlined below 


(a) The upper 7 address bits is first written to the page 
memory in a way as illustrated in previous section 


(b) The lower 4 address lines are feed through the CDP1869 
to reach the address input of 46. 


(c) “character memory access mode" are turned on by programming 
the CDP1870. Now, CPU data bus is connected to the data 
bus of U6 through internal multiplexer of the CDP1870. 


(d) A write pulse is fed from the CMWR pin of CDP1869 to 
strobe the data into U6. 


10. Dynamic RAM Subsystem 


This system consists mainly of elght 32K x 1 bit dynamic memory IC 
(U22-U29). Each IC will serve one data line. 

The address inputs of dynamic RAM are multiplexed. ROW address is 
routed through Ul14(1) and U15(1) and is strobed into the internal 
latch of the dynamic memory by the RAS (row address strobe) pulse. 
ROW address is the lower 7 bit of the CPU address, i.e. Af to Ab. 
The higher address (A8 to Al3) is first stored in the address latch 
(U9). Al4 is provided by the jumper Jl and A7 provided by the MA7 
line of CPU. A7 to Al4 together forms the COLUMN ADDRESS input for 
the dynamic RAM. These "column address" is gated through U10 and 
U15(2) to reach the dynamic RAM inputs. 
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P.10 


40. Ul2 is a timing signal generator. It is clocked by signal at 
pin 9 and generate a series of timing pulses for the operation 
of the dynamic RAM and their associated buffers. 


Ul8 1S an CPU address decoder. It decodes address for dynamic 
RAM and ROM. It will generate enable pulse for the appropriate 
IC when the CPU give an address corresponds to the address range 
of a particular IC. 


ra ae 


interrupt And DMA Circuit Operation 


Many home/personal computers suffers from INPUT/OUTPUT overheads. 
In COMX 35 this is minimized by implementing buffered interrupt- 
driven screen and pseudo interrupt-driven keyboard input. 


In the process of generating vertical-sync for the video display, 

the CDP1870 provides a PREDISPLAY signal which envelops the timing 
period during video display scanning. When this signal is inactive 
(HIGH), the character memory and the page memory are free for access. 
If the output software waits for free accesses to these memories, CPU 
time will be wasted. 


In COMX 35, the display output routine does not access the screen 
memory directly. Instead, the output characters are buffered in 

a FIFO memory. Interrupts are generated by the PREDISPLAY signal 
(60 Hz/50Hz). The interrupt routine will flush the output characters 
in the FIFO memory into the page memory at the appropriate screen 
locations. Before returning back to the BASIC interpreter, the 
keyboard encoder is checked for key entries. Any keyboard input 
will be passed to a one-byte input memory buffer. BASIC will check 
this buffer whenever it proceeds to a new program line. Any 'ESC! 
key press will inhibt BASIC to continue onto the next line and thus 
breaking a BASIC program. 


The interrupt-handing hardware normally operates in the following 
manner : 


(1) CDP1870 generates a LOW on PREDISPLAY (Pin 2) 


(2) The signal goes to Pin 11 of U19 (FLIP-FLOP) and clocks its 
outputs pin 15 LOW (provided IDEN becomes LOW after Ppower- 
up. Will be explained in section 12) 


(3) CPU Pin 36 (INT) is driven low through CR1. The running program 
will be interrupted if the interrupt enable flag inside the 
CPU is set HIGH. (Note: During power-up sequence, the CPU 
will not respond to INTERRUPT even the INT line is driven LOW) . 


(4) When the CPU responds to an interrupt, external hardware is 
notified by SCY and SCl (state codes). U16 decodes these 
state code signals and generates an interrupt acknowledge 
pulse on output Pin 7. This signal will drive Pin 8 of U19 
and releases the INT line. 


Pele 


(5) To prevent interrupts occurring during RESET period and 
power up routine. Output of U19 Pin 15 is held HIGH by 
a HIGH input on Pin 8. This is driven by U16 Pin 12 
which is set LOW whenever 


CLEAR 


i 


g 





or IDEN = ] 
or IACK = ] 


(6) The above process take Place in several microseconds and 
repeats at a rate of 50/60Hz. This is hardly seen on an 
oscilloscope without delay-sweep or storage. However a 
logic probe (pulse stretcher) may be used to detect the 
presence of these short pulses. 


Dynamic memory in COMX 35 is refreshed by DMA. An external 
counter (U20) is implemented to count on "execution cycles" 
and generate DMA OUT requests to the CPU. Upon acknowledging 
a DMA OUT request, the CPU will exercise a dummy memory read 
cycle at an address of value given by the DMA register. The 
DMA register (R(@)) will auto-increment after each DMA cycle. 


However, R(%) is also used as program counter on power-up. To 
avoid instructions being skipped before another register R(n) 
is employed for program counter, U20 is held static by CLEAR 
at pin 6 and IDEN at Pin 9. 


Output pin 13 and pin 2 of U20 should be free-running pulses 
during normal operation after the Power up routine. 





IDEN - Interrupts and DMA enable (ACTIVE LOW) signal is the master 
controlling signal over the interrupt and DMA Supporting hardware. 
This signal is HIGH( inactive) during RESET and Power-up routine 
to suppress interrupt and DMA activity before the CPU is ready to 
handle them. This signal will go LOW (active) after the power-up/ 
RESET routine and stays LOW unless the COMX 35 is RESE? again 
manually or powered-down. 


P13 


12. Power-up Self-Diagnostic Routine 


(ROM source listing line numbers are given for reference only) 


(1) 


(2) 


(3) 


(4) 


(5) 


(6) 


(7) 


Line 4] 

Starting at location 29990, six no operation instructions 
(NOP : $C4) are used to allow pending DMA requests to be 

cleared. Even if any of these instructions are Skipped, 

program flow will not be disturbed. 


Line 42-43 
R(B) is set up as program counter. This is done to release 


R(G) for DMA activity afterwards. 


Line 49-54 
Turn on high tone and stack pointer is initialized 
((Note CDP1869 «£ CDP187$ are accessed for the first time)) 


Line 26-109 

System perameters are initialized with default values from 
ROM. CPU records NTSC/PAL diode installation by checking 
EF2 ((DRAM is being accessed here for the first time) ) 


Line 112-117 
Screen memory (page memory) is initialized with £20 (SPACES) . 


((Page memory is accessed here for the first time)) 


Line 119-125 

Q line (pin 4 of CPU) will be set HIGH and then set low. 

This will clock U19(1) and TDEN will become LOW. 

((A very short HIGH pulse appears on Q line. U20 begins 
to count and DMA action Starts) 


Line 127-146 
Character memory is initialized by copying the character 
definition table from ROM. 

DRAM is used here. If fault exists on data lines between 
CDP1870 and character RAM, destorted characters will be seen 
after screen is turned-on at line 218, 

((character memory is first accessed there) ) 


(8) 


(9) 


(10) 


(11) 


(12) 


Line 112-209 
Page. memory is rewritten with 'COMX' logo' pattern. Different 
colour horizontal bars is used to distinguish between NTSC-PAL 


framing. 


NTSC : - YELLOW/CYAN BAR 


PAL - GREEN /BLUE BAR 


Line 218 


Screen is turned on now. 





((coloured COMX logo is seen on the screen now)) 


Line 224-235 


Two tone bursts are produced with decaying amplitudes. 


Line 250-267 





Colour of COMX logo is changed around every seven seconds. 
Keyboard is continuously monitored. If any key other then 
‘SPACE' is pressed, the system will proceed to bring up 
BASIC, 


Line 268-213 


Screen is cleared first. 
Display colour is changed to normal CYAN/WHITE. 


Bring up BASIC 
Note : - DRAM_integrity is essential for start-up of BASIC. 


~ dInterrupt circuity integrity is essential to display 


COMX BASIC V1.@¢ 


READY 





because BASIC output is interrupt driven. 


- Keyboard will be read only if interrupts occurs. 
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Expansion Guide 


For 


COMX 35 


EXPANSION GUIDE 


Note: To be used with I/O map, memory map and expansion socket pin 
assignment. Knowledge of 1802 CPU is assumed. 


(A) Hardware 


A.l 


A.2 


Expansion Bus 
See ei eS. 


On COMX 35 expansion bus, Pin B and Pin 8 are used by expansion. 
Peripheral expansion boards should Support these signals or else 
they will not be supported by the expansion box of COMX 35. 


Pin B (DS) - This signal is generated by the electronics of the 
expansion box. This signal should be used to enable 
the devices and memory on the expansion board 
inserted into that connector to be mapped into the 
I/O space and memory space. ; 
Therefore memory and I/O decoding of any expansion 
board should include this signal. However, this 
pin is not driven on the side connector of COMX 35% 
In order that an expansion board will work with 
COMX 35 at the absence of the expansion box, this 
Signal should be pulled up to +5V by a resistor 
(typically 10K ohm). 


Pin 8 (DP) - This signal should be generated by any expansion 
board whenever its devices and memory is being 
accessed. This signal will be detected by the 
expansion box electronics in controlling bi-directional 
data-buffers. This signal should be driven by open- 
collector driver or normally through a diode. Do 
not pull up. 


Program in ROM/EPROM 


On any expansion board, program in ROM should be mapped to address 
starting at SC#P~O (HEXIDECIMAL). Try to avoid partial decoding. 
Address signals Al5 and Al4 are present on the expansion bus. A 
hex-flip-flopclocked by TPA falling edge will latch A8-Al3. Address 
range $CXXX can then be easily decoded using OR gates only. 
Remember to include DS and MRD in decoding. 


A.3  INPUT/OUTPUT 


Input/Output ports on any expansion board must not be mapped 

on top of built in I/O ports of COMX 35. Decoding must include 
DS. Input port 2 and Output port 2 are recommended to be used. 
For data width not more than 8-bit, information should be Passed 
through the data bus. For input data width more than 8-bits, 
Input ports 4-7 can be used with information passed on data bus, 
For output data width more than 8-bits, CPU OUTPUT Q can be used 
to duplicate output port 2. 

16-bit output can also be achieved by using 1802 register output 
as in 1869. Output port 2 can be built to latch R(X) information 
multiplexed on the MA lines. Note that upper-byte is latched 
first. When 1802 outputs, memory will be read at the same time. 
When 1802 inputs, memory will be written at the same time. 
Therefore one does not have to worry about memory corruption 
when using OUT N for output operations. However, INP N can also 
be used for output if the hardware is set up correctly and the 
software written carefully. One can use INP N for Output by means 
of register output through MA lineS$, The hardware is set up to 
detect INP N and latch information of R(X) on the MA lines. Un- 
fortunately a write to memory anddressed by R(X) will take Place 
at the same time. This is not a problem if the range of values of 
R(X) is restricted to Point to areas of memory space which are 
non destructive (e.g. ROM, EPROM). This must be taken care by 
the driving software. 


een 


MRD Should be .used to distinguish between INF N and ouT N. Using 


MWR in controlling tri-state input buffers will give very Short 


data window in writing memory. Output port should accept new data 
on Signal edges. If a level-controlled latching output port is 
used, glitches may be present on the Output—port outputs. 
Memory-mapped I/O should be avoided. In cases the user insists 
to implement memory mapped I/O, they should Overlay them on top 
of the ROM/EPROM on the same expansion board. 

Remember to include DS in decoding. 


RAM 


—emie, 


Small amount of RAM can be obtained from system area of built-in 
RAM. Please check memory map and software section of this guide. 


Power 


Any expansion board should not draw more than 150 mA from the 
+5V regulated supply. Any expansion should not draw more than 
250 mA from the V+ (=9V) unregulated supply. Total draw from 
both supplies should not exceed 250 mA. 


Standard Dimension 
SSS SE EMENS LON 


See enclosed drawing for standard size. 


Protection Cover 
See eee Pe OM OVer. 


Comx supplies protection cover for standard size expansion 
boards. Minimum delivery quantity is 1000 pe. 


Indicators 
Iwo LED's should be present on an expansion board. 


SELECT - Indicates that the board is selected. Normally derived 
from the signal Ds. 
ACTIVE ~- Indicates that the board is being accessed. 


Expansion Guide 


(B) SOFTWARE 
B.1.9 Program ROM/EPROM Header 


In order to maintain compatibility between COMX system software 
and software developed by add-on firms, several rules must be 

observed for all programs stored on add-on boards. The system 

will not function properly if these rules are violated. 


B.l.1 Board Function Code 


A '00' byte must be stored at location CGPP (HEXIDECIMAL) for 
boards containing ROM/EPROM. 


B.1.2 Board Identification Number 


Every type of add-on board should contain an identification 
number. When a board selection command is issued in BASIC, 

the system program will sequentially enable each of the boards 

in the expansion box and search for the existence of a board 

with a particular IDENTIFICATION NUMBER. When the board is 
found, the system will electrically enable it and make sub- 
sequent access to it. If the board with that IDENTIFICATION 
NUMBER does not exist in the system, BASIC will return an 

error message. 

The board selection command must indicate the IDENTIFICATION 
NUMBER of the desired board. The system software will search 

and access it; hence the add-on board can be plugged into any 
slot within the expansion box. 

There are totally 8 banks in the bank-switching mechanism and 
labeledas bank @ to bank 7. 

The IDENTIFICATION NUMBER is one byte long and located at address 
C$9l (HEXIDECIMAL). Hence there will be 256 (0 to 255) different 
ID NUMBER, Address C§9P (hexidecimal) should contain 00 to Signify 
that an ROM/EPROM exist at that location. The System software 
will try to modify this byte; the system software will know that 
it is a ROM/EPROM if the modification fails. 


B.1.3 Search Mechanism 


For example, 3 add-on boards has been inserted into the expansion 
box. They are : 
BOARD TYPE 
(BANK NUMBER) 
VOICE 
SYNTHESIZER 


DISK 
INTERFACE 
















SLOT NUMBER BOARD ID NUMBER 
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B.1.4 


If the user wantsto activate the printer in order to get 

a program listing, he must first find out that the ID- 
ENTIFICATION NUMBER of his printer interface card is equal 
to l. He then issue a command : "SELECT 1". 

The system program will first electrically enable bank 0 
and read the ID number at location C9@l (hexidecimal). 

The data read will be equal to 3 and fails to match the 
desired board ID number. The system program then de-selects 
bank 0 and enable bank 1 and read the ID field again. The 
result is 2 and no match is obtained. The system software 
will sequentially enable the next bank until the desired ID 
number is found. 


Board Identification Assignment Scheme 


If two add-on boards happens to have same ID NUMBER, only 

the board located at a lower bank can be found and used. 
Therefore, it is very essential that boards manufactured 

by different manufacturers must not have same IDENTIFICATION 
NUMBER. Moreover, if any manufacturer expects user to install 

2 or more cards of the same type, he must provide some hardware 
options (e.g. DIP SWITCH) that can make these two or more boards 
appears to have different ID NUMBERS when it is being in- 
terrogated by COMX system software. 

In order to avoid ID number crash, Comx World Operations Limited 
has taken up the regulatory responsibility. Add-on firm should 
consult Comx and have an ID NUMBER assigned to each of their 
product. These ID number should also be shown on each of the 
add-on cards so that the card-users can know the ID NUMBER of 
their cards. Since the user will not buy two functionally 
identical cards and install them in one system at the same time, 


therefore, COMX may assign identifical ID NUMBER to all functionally 


identical cards manufactured by different manufacturers. 
Hence, full functional description of an add-on card must be 
included in all ID NUMBER assignment application. 


Command Entry Point Count 


Address COQ92 (HEXIDECIMAL) must contain the number of user entry 
points of the program stored on the ROM/EPROM. 

This number is to be referenced by COMX system program. 

Each user entry point usually performs a different task when 
"called" by user. 


Bot 


Identification In Plain Language 


This field is 40 bytes long. Card manufacturers should include 
the name of :the board and its ID number in this field. 

COMX DISK OPERATING SYSTEM will read this field and print out 
names of board in the system after booting. 

This 40 bytes must be in ASCII code and will be printed as one 
line after booting. Unused bytes must be filled with Spaces 
(HEX 29) 


Command And Execution Table 


This table contains jump instructions and its associated English 
command keywords. 

Each entry is 16 bytes long. The first 3 bytes will be a LONG 
BRANCH instruction. It is followed by the board ID NUMBER and 
a Short English command string (in ASCII code). This string 
Should be about 3-6 characters long; longer or shorter strings 
should be avoided if possible. 

This command string should give the meaning of the function 
performed by this entry point clearly and concisely in plain 
or abbreviated English words. 

This command and execution table starts at location C040 (HEX) . 
Each entry is 16 bytes long and a maximum of 12 entries is 
allowed. The first entry should point to a subroutine that 
will call up the Nth subroutine as listed in the execution 
table,N is a parameter number passed in the CALL command in 
BASIC eg. CALL (@C040,3) will pass control to the subroutine 
located at CO40(HEX). It will then, in turn, pass control to 
the subroutine 3 in the list. Allowable parameter range is 

O toll inclusively. 

The command and execution table contains 12 entries of 16 
bytes each. The table begins at memory location C040 (HEX) 

and ends at location C@FF(HEX). 


ADDR 





C000 
COLO 
C020 
C030 
C040 
C050 
C060 
C070 
C080 
C090 
COAO 
COBO 
COCO 
CODO 
COEO 
COFO 


0001 
3030 
4E54 
4152 
C0C4 
Cocl 
Ccocl 
COCc1 
coc] 
COC1 
cocl 
cocs 
COC5 
COCs 
COC4 
COCc5 


Example 


OBFF 
3120 
4552 
414C 
5501 
0301 
4FO1 
1001 
2501 
3A01 
6201 
0601 
0601 
0601 
7DO1 
0601 


FFFF 
5354 
2049 
4C45 
5053 
504D 
504D 
504D 
504D 
504D 
504D 
4455 
4455 
4455 
5345 
4455 


COMX 35 Standard Printer Interface Driver ROM 
a ee ee ceri ace Priver KOM 


FREE 
414E 
4E54 
4CFF 
454C 
4F44 
4F44 
4F44 
4F44 
4F44 
4F44 
4D4D 
4D4D 
4D4D 
4C46 
4D4D 


FFFF 
4441 
4552 
FFFF 
PEEF 
4530 
4531 
4532 
4533 
4534 
4535 
59FF 
ODF E 
SIEF 
5445 
DORE 


FFFF 
5244 
4641 
FEFF 
FFFF 
PFFF 
PREF 
PREF 
FFFF 
FFFF 
FREE 
PREP 
FFFF 
FREE 
5354 
PREP 


FFFF 
2D50 
4345 
FFFF 
FFFF 
FFFF 
FPFFF 
FFFF 
FEFF 
FFF 
FFFF 
FEF 
FFFF 
FFFF 
FFFF 
FPFFF 


FREE: 
5249; 
3A50; 
FFE; 





ROM ID NUMBER = 1] 
001 STANDARD-PRINTER 
INTERFACE: PARALLEL 


COMMAND KEYWORD 
AND EXECUTION TABLE 


B.2.0 PROGRAMMING GUIDE LINES 


Be2ed 


Memory Configuration 


Each add-on I/O board will contain at least one ROM 
OR EPROM containing its associated driver-program. 

A 2732 type (4K x 8 bits) EPROM is recommended as 

the availability and price of 2716 type EPROM is not 
stable nowadays. This memory size may be excessive 
in some applications, but there are ways to take 
advantages of this large EPROM/ROM space. The add-on 
board needs not contains its own RAM if the number of 
bytes required is not large. The driver program can 
use RAM in the COMX 35 basic unit. 


RAM Area Allocation Scheme 


Comx World Operations Ltd. has reserved some RAM area 

in the COMX 35 computer for add-on boards. In order 

to maintain compatibility between different add-on 

boards and between each add-on board and the system- 
program, add-on board manufacturers should contact 

COMX by writing or telex for RAM usage assignment if 

RAM inside the COMX 35 computer are to be used. COMX 

will assign some memory location to be used by each 

add-on board and make sure that all these add-on boards 
can be installed into one system and work properly. 
Basically, if two boards manufactured by different 
manufacturers happens to have identical functions, COMX 
may aSsign same memory locations to these two manufacturers 
since their products will not be put into one system and 
be operated at the same time. We will assign unique ID 

& RAM space to boards which are functionally different. 
Hence, we will ensure that these board will not interfere 
with each other and be able to work together in one system. 


Usage for RAM Inside COMX 35 


RAM area to be used by add-on boards is classified into 3 
categories : 


(A) SCRATCH PAD RAM ( temporary storage, small size) 


These area will be common to all add-on boards. The 
add-on-board program can access this area for tem- 
porary storage of data. Once the program finishs 
its job and return control to other program, this 
area may be used by other programs. Interrupt 
service routines will NOT change data stored in 
these area. This area is limited in size. 


(B) 


(C) 


PRIVATE RAM AREA (Permanent storage,very small size) 


These memory locations is reserved for private 

use by different add-on board. These area are 

to be used for permanent data storage and storage 
of system-parameters. This area is very limited 
in size and the add-on board programmers are urged 
to make effective use of these RAM area. Usually, 
only a few bytes will be assigned to each add-on 
board. 


STACK MEMORY (temporary storage, large size) 


This is the ONLY place where larger amount of memory 
space can be obtained for temporary storage. The 
add-on-board program will decrement the system 
stack pointer (CDP1802, register 2) and leave a 
empty ‘STACK FRAME' for its usage. All memory 
access in the area will be referenced to the entry 
stack pointer value. The program will increment 

the stack pointer (by same amount as the decrement) 
before passing control back to the system program. 


The program step will be shown as follows : 


(a) Disable interrupt before decrementing the stack 
pointer to avoid wrong interrupt sequence. 
This is to avoid the stack pointer being changed 
by interrupt service occuring during stack pointer 
manipulation. 


(b) Save two registers,for example, register D and 
register E into system stack. 


(c) Copy the system stack pointer into the saved 
registers, Register D and Register E in this 
example. 


(d) Decrement Register 2 by the amount needed and 
enable interrupt again. 


(e) Do the processing needed; storage access will be 
referenced by displacement from Register D. 


(f) Disable interrupt. 


(g) Restore system stack pointer by copying Register 
E into Register 2. 


(h) Pull original contents of Register D and Register 
E from system stack and restore them. 


(i) Enable interrupt. 


(j) Pass control back to system program. 


The program can use standard call and return technique (SCRT) as 
the data will be stored in new stack locations after the stack 
pointer is decremented. However, the program must restore the 
stack before leaving. i.e. all memory locations in the new-stack 
area must be released. 


Stack 
Pointer ———+ DE! esos’ 
Free 
Stack 
Frame 
Free 
Area 
SP Stack 
_.Grow 
Here 
Stack contents Decremented Restored 
before entering stack pointer stack pointer 


this program 


B.2.4 MEMORY MAP OF COMX 35 RAM 


ADDRESS IN HEXIDECIMAL 


BFFF RESERVED FOR DOS BUFFER 
BEEQ 


BEDF\ app-ON BOARD DRIVER RAM 
BEOO }) CONSULT COMX FOR ASSIGNMENT 








BDFF 
SYSTEM 
STACK SYSTEM STACK GROWS 
SYSTEM FROM BDFF (HEX) DOWNWARD 
BUACK. sates SS 
7 ba 
BOD ots User data stored on top of user program 
USER DATA 
EOD . 
USER PROGRAM User program grows 
from 4400 (HEX) upward 
4499 (HEX) up 
SYSTEM RAM 4000 





B.2.4 


MEMORY MAP OF COMX 35 RAM 


The system stack pointer is set to BDFF (HEX) upon system reset. 
The system stack pointer will decrement as the System stack grow. 
The first statement of the user program is located at memory 
location 4400 (HEX) and user program's data are stored above the 
end of user program. 

User can find out these pointers’ value by typing 'EOP' and ‘EOD’. 
The system will print out the values of the end of program pointer 
and the end of data pointer in hexidecimal numbers. 

There is another BASIC function called 'MEM'. This function will 
return the value of memory left in the System. MEM is calculated 
by the formula : 


MEM = (TOP OF SYSTEM STACK) - (271) - (EOD) 


The system has reserve 271 bytes for its stack grow area and will 

give a negative value of MEM when the user data has grow into its 
reserved area.‘ MEM WARN> will be displayed to warn the user of this 
situation. The system will crash when the user data overwrite the 
System stack area. 

If the add-on-board uses memory location in the stack area, the user's 
manual must give a warning to the board user. For example, if the 
add-on-board needs 512 bytes of memory in stack area, it must tell 

the user to stop entering program into the COMX 35 when the MEM value 
reach 512 or less. User should be advised to type "PRINT MEM" to find 
out the MEM value when a large (about 30K bytes long) BASIC program is 
entering into the COMX 35 computer. The COMX 35 has 32 kilo bytes of 
program memory and user program seldom has memory shortage even if the 
add-on-board use up some of the stack RAM. However, the add-on-board 
programmers are still advised to make efficient use of stack memory to 
preserve the effectiveness of the{ MEM WARN > warning message. 


Standard call and return technique (SCRT) 
a EE bOCNNIGUE (SCR) 


A full description of this technique is given in P.55-P.66 of RCA 
publication MPM-2$1C, user manuals for the CDP1802 COSMAC micro- 

processor. All CDP1802 system programmers and hardware designers 
are advised to obtain a copy from RCA. 

In COMX 35 BASIC, Register 4 and Register 5 will always point to 
the CALL and RETURN routine inside the BASIC ROM. 


P.12 


To call a subroutine, the user simply write : 


use-R4 as program counter 
subroutine address 
stored in 2_ byte 


continue execution 
at 0003 (HEX) 
after return from SUB 





This calling sequence will destroy Register F high byte as it is 
used to store. content in accumulator D. 2 bytes of stack RAM 
are used on each subroutine call. 


To perserve RF high byte. Use this sequence : 





To return to the main program, the subroutine should end with a SEP 
R5 instruction 


le ~-- subroutine body 


~~~ return to calling routine 





This will use RF (HIGH byte) to store accumulator D 


To preserve it, use this routine. 


ie 


~~~ put RF.1J into D 
--~- return 





The SCRT routines stored in COMX 35 
reference. 


STANDARD CALL AND RETURN ROUTINE 
ee ee i 
(Stored in COMX BASIC V1.00 ROM) 


ROM are listed below for your 


Note : STCALL is pointed by Register 4 
STRET is pointed by Register 5 

WK represents Register F 

SP represents Register 2 

LINE represents Register 6 

PC represents Register 3 
2E13 3 SR re ee ne ene ee 
ZE13 ¢ 3139 -- STANDARD CALL PROGRAM... 
ZEAL 3 3140 --STCALL A 
2E13 >; ae ae eh ces Ne hehe Soa 8 cht edo 
2E13 D3; 3142 SEP PC 
2E14 BFE2; 3143 STCALL PHI WK; SEX SP 
2E16 96738673 3144 GHI LINK; STXD; GLO LINK; STXD 
2EIA 83A693B6 3145 GLO PC; PLO LINK; GHI PC; PHI LINK 
2ElE 46B346A3 3146 LDA LINK; PHI PC; LDA LINK; PLO PC 
2E22 OF; 3147 GHI WK a 
2E23 3013; 3148 BR STCALL-1 
2E25 ; Se En ere a ee 
31EA ; 3668 
31EA ; St a ee err Ore ee ee ee 
31lEA ; 3670 --STANDARD RETURN PROGRAM... 
3IEA ; 3671 - -STRET A 
31EA ; 3672 Se AE S/R BEE Be Sele Bw we ace Whee 
31EA D3; 3673 SEP PC 
31EB BFE2; 3674 STRET PHI WK; SEX SP 
31ED 96B386A3; 3675 GHI LINK; PHI PC; GLO LINK; PLO PC 
31Fl 12; 3676 INC SP 
31F2 42A602B6; 3677 LDA SP; PLO LINK; LDN SP; PHI LINK 
31F6 OF; 3678 GHI WK 
31F7 30EA; 3679 _BR STRET-] 
31F9 ; 3680 and eee ees ere reer Scie as aie aia ianydsa eal a! Ghat gee Sse Sue cog 
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Comx World Operations Limited 

\5/F Wo Kee Hong Building 

\85-609 Castle Peak Road | 

Kwai Chung, N.T. Hong Kong 
Tlx : 45823 CODAT HX 


COMX 35 Expansion Registration 
ee ee EEE LOR: 


Application Form 


(1) Name of Add-On Card : 
. . . esc 
Function/Application : 
eee 


(2) ROM/EPROM Size : K bytes 
(3) Number of Input Bits : e.g. 8+3 
(4) Number of Output Bits : e.g. 1643 
(5) Q USED (Y/N) : For 
es ein te SUE 
EF4 USED (Y/N) 3 For 
pe he SR 
(6) RAM Requirement : Scratch Pad bytes (Max. 20 bytes) 
Private Status bytes (Max. 8 bytes) 
Stack bytes 


. 





(7) Input/Output Method : 














Function 
é€.g. Output 12 bits 


Instruction Information Passed On 


e.g. IN 1 e.g. MAG - MA1I 


















(8) Number of Entry Points : 
(9) Interrupts Masked (Y/N): For Periods of MS/MS MAX, 





(10) Power Consumption : 9V unregulated : mA 
+5V regulated : mA 


(ll) Detailed Description of Operation and Programmable Configurations : 
(Please use additional page(s)) 


FOR COMX USE ONLY : - 

Scratch Pad RAM Address 
Private Status RAM Add. 
Stack Memory Allowance 


ID Number 
Notes 











Assigned On 











By : 






&e te te or 












For and on behalf of 
Comx World Operations Ltd 
Ref No. 








Expansion Socket 


Pin Number 
Top Bottom | Function 
1 Ground 
A Ground 
2 NC (Reserve for negative supply) 
B NC (Reserve for DEVICE SELECT SIGNAL (DS) == P>* 
3 +5V (Regulated, 150 MA available) 
C V+ (Unregulated ~ 9V) 
4 Data bus §@ 
D Data bus 1l 
5 Data bus 2 
E Data bus 3 
6 Data bus 4 
F Data bus 5 
7 Data bus 6 
H Data bus /7 wee) 
8 NC (Reserved for DEVICE PRESENT signal (DP)) 
J CPU Q output (PIN 4) Cassette output signal 
9 - CLEAR PIN OF CPU (CDP1802A, PIN 3) 
K MRD memory/I0 READ 
10 TPA (timing pulse A, CPU PIN 34) 
L NG CPU pin 19 
11 N1 CPU pin 18 
M N2 CPU pin 17 
12 RAS row address strobe of DRAM (MSM3732 pin4) 
N INT INTERRUPT, cpu PIN36, 10K ohm PULL UP 
13 WAIT , CPU PIN 2, 10K ohm PULL UP TO +5V 
; P CLOCK CPU clock, 2.8 MHZ, CDP1870 PIN 38 
14 SC I CPU PIN 5 
R SC ¢g CPU PIN 6 


15 EF4 CPU PIN 21 


PIN NUMBER 

S 
16 

T 
17 

U 
18 

V 
19 

W 
20 

X 
21 

Y 
22 

Z 


CASE 
TPB 


AS 
MWR 
Al4 
iM A7 
Al4 
MAS 
M A6 
MA4 
MA3 
M A2 
EXTROM 
MAIL 
MAG 





PIN 
NUMBER 


Function 

column address strobe enable 

CPU PIN 33, timing pulse B. 
Negated address line 15. (latched) 


memory/I0O write 
latched address line 14 
Multiplexed address 7 


Negated latched address line 14 
Multiplexed address 5 
Multiplexed address 6 
Multiplexed address 4 
Multiplexed address 3 
Multiplexed address 2 
Disable internal ROM completely 
Multiplexed address 1 
Multiplexed address ¢ 


Front view of expansion socke 1 
(View from right side of COMX 35) 


Memory Map of COMX 35 





Location Description 





Build-in system ROM 
Contains (1) BASIC INTERPRETER 
(2) TV and keyboard operating system 


Q0000 - 3FFF (hexadecimal) 


(3) Cassette operating system 


4000 - 43FF System parameter storage area. 
4400 - BDFF BASIC 'PROGRAM' and 'DATA' storage area. 
Top of system stack located at BDFF. 
BEOQO - BFFF Reserved for disk operating system 
COOO - DFFF 8 banks of 8K bytes 
~ Used for system expansion 
- Program must select the desired bank before 
making read/write operation to this area. 
E000 - EFFF “Reserved 
- Used for inter-bank communication 
~ For application that cannot be fitted into 
one 8K byte bank. 
FOQOO - F3FF Reserved 
F400 - F7FF Character definition RAM area. 


- This carea hotds ‘the. dot pattern of the 
128 characters. 


- The character can be changed using the 
SHAPE command in BASIC. 


- Each character uses 9 bytes in PAL system. 
- Each character uses 8 bytes in NTSC system. 


- This area can only be accessed by turning on 
the "character memory access" mode of the 
CDP 1869 IC. Refers to data sheet for 
details. 


Memory Location Description 


F800 - FFFF Screen page memory 


- Each byte holds the character code of 
one display character position on 
the screen. 


- Before scrolling, F800 represents the 
left-top character position on the screen. 


F801 is the one next (to the right) to it 
and so on. 

FBBF represents the bottom-right position 
on the screen. 


- Hardware scrolling is accomplished by 
Changing the home address register 
inside the CDP1869 IC. Refers to 
CDP1869/1870 data sheet for details. 


- This area is write-only and can only be 
accessed during the non-display period. 
The program may wait for non-display 
period and directly write to this area. 


e.g. Bl $  ... check EF1 and wait 
for non-display 


STR R7 ... write to this area. 


INPUT 


OUTPUT 


Input / Output Port Assignment 


FREE 
FREE 


KEYBOARD ENCODER IC INPUT ( use data bus) 


FREE 
FREE 


] 
2 
3 
4 FREE 
5 
6 
/ FREE 


1 BANK SELECT 

2 FREE (normally used for system I/0) 
3 CDP 1870 CONTROL (use data bus) 

4 CDP 1869 CONTROL (use M/A bus of CPU) 
5 CDP 1869 CONTROL (use M/A bus of CPU) 
6 CDP 1869 CONTROL (use M/A bus of CPU) 
i CDP 1869 CONTROL (use M/A bus of CPU) 


User installed I/0 device can use INPUT/OUTPUT port number 2. 


Bank select program 


Machine code Source program 


SEX R3 
OUT 1 

DC 2 
SEX R2 


...- P=3, x=2 when enter to this program 
. X points to program counter 


... select bank 2 
. reset x=2, normal stack pointer 


In line 3, the constant will determine the bank being selected. 


Will select bank 1 to be the active bank 
Will select bank 2 and so on. 


i 


-@. 


] 
2 


1/0 


g 
1 
2 
3 
4 
5 
6 
7 


I/O MAP 


FIRST +VE GOING EDGE 
ENABLES DRAM REFRESH 
ENABLES INTERRUPT BY PREDIS 
CASSETTE OUT (MIC) 


PREDIS 


ON POWER UP 1=PAL 
Q=NTSC 
AFTER TOGGLE Q = EFXB 


EFXA 


CASSETTE IN (EAR) 
MAY BE OVERODE 





D= Data Bus 
MA= Multiplexed Address Bus 


MEMORY MAP = 


nee SCREEN RAM 
F/7FF CHARACTER RAM 


[FSF || _Reservep 1K eee 


oe 
RESERVED ' 
> 3 


hk § 6 FT 
COG 


ic 
4990 


3FFF 


Start 










IPOP 


Software 


System Software Bulletine Issue I 


Character Size Selection 


The COMX 35 computer can display characters in any one of the following 
FOUR formats. 


1. Normal size characer - The display is 24 rows by 40 columns. 960 


characters are displayed on TV screen. This is the “normal” operation 


mode and is the only mode supported by BASIC. 


2. Horizontally expanded - The characters are twice as wide as the normal 


characters. Height are unchanged. The display become 24 rows by 20 
columns and 480 characters are displayed. This mode is not supported 
by BASIC and only the upper half of the "page memory" is displayed on 
the TV screen. Some characters will "fall below" the TV screen and 
not displayed. 


3. Vertically expanded - Characters are twice as high but width remain 
normal. The screens becomes 12 rows by 40 columns. As in mode 2, 


only 480 characters are displayed; others will "fall below" the screen 


and will only be displayed after scrolling up. 


4, Vertically and horizontally expanded - This is a combination of mode 2 


and 3; the characters are now twice as high and twice as wide. Only 
240 (i.e % of normal 960 characters) characters are displayed. Other 
will "fall below" the TV screen. The characters size is now 4 times 
as big as the normal size. 


Changing Character Size 


Horizontally Expanded Mode. 


Turn  POKE (s8 41CQ, PEEK (m41CQ) AND #7F) 
On SCREEN ( PEEK (m 410) + 1) 


Turn POKE (™41CQ, PEEK (# 41C@) OR #80) 
Off SCREEN ( PEEK (m 41C@) + 1) 


Vertically Expended Mode. 


Turn POKE (#84103, PEEK (m8 41C3) AND #7F) 
On NOISE ( PEEK (m8 41C4) +1, PEEK (mm 41C3)+1) 


Turn POKE (@41C3, PEEK (s§41C3) OR #80) 
Off NOISE (PEEK (mi 41C4) +1, PEEK (me 41C3)+1) 


Vert and Horizontally Expanded Mode. 
Do the turn ON program of both mode (1) and mode (2). 


Return to normal mode. 
Do both the turn OFF program of mode (1) and(2). 


NOTE: 2 


Horizontal Expand 


POKE (mm 410%, #60) 
SCREEN (1) 


POKE (BB 41CQ, #£0) 
SCREEN (1) 


Vert Expand 


POKE (M@ 41C3, @) 
NOISE (0,0) 


POKE (@ 41C3, #08) 
NOISE (0,0) 


POKE (m 4103, #80) 
NOISE (9,9) 


POKE (Mm 41C3, #88) 
NOISE (@,@) 


Changing Character Size (Simplified) 


Tey 
] OFF 


TONE, SCREEN, COLOR, NOISE, MUSIC 
commands issued may be scrambled and 


resulted in later operation. 


Use this simplified produce in demonstration only. They will work 
properly if none of the above named command has been issued after 
reset. Use the proper procedures listed on previous 


page for all programs. 


the last system 


(PAL) 


(NTSC) 
(PAL) 


(NTSC) 


irregular response may be 


System Software Bulletine (Issue 2) 


Maxing Machine Language And BASIC Language Programs 


1. INTRODUCTION 


Machine language program can perform a given task significantly faster 
than the equivalent program written in BASIC language. Hence, it is 
desirable to write programs in machine language whenever higher exe- 
cution speed is preferred. This specifically true for programs that 
involve movement of graphical objects on the TV screen. 


However, writing a machine language program is not an easy task. [It 
may take significantly extra effort and time when compared to the 
writing of an equivalent program in BASIC. Hence the most efficient 
way to do the job is to inter-mix programs written in these two 
languages. The calculation and decision making routines may be 
written in BASIC language so that it can be quickly written and de- 
bugged. Complex algorithms can also be implemented easier in the 
BASIC language. Part of the graphics, sound and colour routines may 
be written in assembly language to improve their execution speeds. 


Programmers should use the following approach 


(A) Write the whole program in BASIC language first. Care is taken 
in separating the program into several functional blocks which 
may be replaced by machine language routines at a later stage. 


(B) When the whole program has been debugged and is running flaw- 
lessly, the program flow should be re-analysed. The speed- 
determinating part of the program is then identified. Usually, 
the speed determinating routines are the screen output routine 
or routines that are repeatedly executed in loops. 


(C) Some routines are then replaced by machine language routines 
until the execution speed of the program becomes satifactory. 
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2. ALLOCATION OF MEMORY SPACE 


The memory map of COMX 35 computer is shown below : 


ADDRESS (hexidecimal) 


BEEO 
ae ADD-ON BOARD DRIVER RAM 


ia RESERVED FOR OS BUFFER : 






BEOO CONSULT COMX FOR ASSIGNMENT 
BDFF 
SYSTEM 
A 
SYSTEM aia SYSTEM STACK GROWS 
STACK FROM BDFF (HEX) DOWNWARD 
- aa 
CoS ae User data stored on top of user program 
USER DATA 
BOD es eee 





USER PROGRAM 


SYSTEM RAM 





User program grows 
44 DD 


From 4409 (HEX) upward 


4D DD 





The COMX BASIC interpreter can accommodate machine language program 


and/or user defined data by storing the user's BASIC language program 


be done by using the 


is can 


Th 
This command will redefine the 


User Space" to a new value as specified. 


10n 


. 


-normal locat 


-than 


at a higher 


"Start of 


For example, if 512 bytes 


DEFUS command in BASIC. 


ded, the "Start of User Space" pointer should be in- 


° 


iS nee 


of memory 


This is illustrated 


cremented by 512 bytes and becomes 469 (HEX). 


by a sample program as shown below 


tr 
or 
LL} eet 


tiene 


xz © 2s 2 & © F 


Fe 


t 


. 


— 


! 


as 27 2 © = ££ & F 


fe Ff © 5 t= Fe FF 





The BASIC interpreter keeps a system parameter called "Start of User Space" 
which define the memory location at which the storage of the user's BASIC 
program starts. The first ll bytes of the "User space" are reserved by the 
system. Actual storage of user's program starts at the 12th byte in the 


user space. 
After power-yp or reset, the "Start of User Space" is initialized to 4409 


(HEX) as a default value. Storage of user's program start at 449C (HEX). 
This is illustrated by dumping the actual memory contents of a sample 


program. 


Note : The memory dump routine is present on the printer interface card. 


LIST the program for reference 


Execute the memory dump program 


Memory contents are shown as 8 HEX 
digits pairs with the address of 
the first hex pair shown on the 
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leftmost column. 


ASCII character are shown on 
rightmost column for reference 
‘pe 
‘Tf 


is 46 
is 49 


The ASCII code for 
The ASCII code for 


i.e. 


The new memory map is shown below : 


SYSTEM 
STACK 


USER DATA 


USER PROGRAM 


SPACE FOR MACHINE 
LANGUAGE PROGRAMS 
SYSTEM RAM 


The cassette PLOAD and PSAVE command will load and save all memory contents 
between 4499 (HEX) and the memory location pointed by the "End of Program" 
pointer. It will also set all appropriate system pointers. 


ADDRESS (HEX) 
BFFF 
BEEQ RESERVED FOR OS BUFFER 


BEDF 5 anp-ON BOARD DRIVER RAM 
BEOO } CONSULT COMX FOR ASSIGNMENT 


BDFF 





SYSTEM STACK GROWS 
FROM BDFF (HEX) DOWNWARD 


SYSTEM 


STACK . 
POINTER 





EOD________» User data stored on top of user program 






User program grows 


Start of User Space 
4690 } From 4699 (HEX) upward 


| 





4499 






4909 


Hence, the machine language and BASIC program can be stored to cassette by 
one PSAVE command and get back from cassette by one PLOAD command. The 
"Start of User Space" pointer will be set automatically. 


BEFORE entering the BASIC program 
The machine language program was 
entered and stored at memory 

User can also use the POKE command 
to store machine language program 
in the memory. 


location 4400 (HEX) 
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The BASIC program was entered, 
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Memory dump showing the machine 


language program 
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ADDING MACHINE LANGUAGE PROGRAM TO A NEW BASIC PROGRAM 
ee eee 


Before the development of a new BASIC language program Starts, the 
programmer must estimate whether machine language routine is needed 
in his program. Appropriate memory space MUST be allocated by the 
DEFUS command BEFORE he type in the first line of BASIC language 
program, For example, typing "“DEFUS 4600" will allocate 512 bytes. 


The COMX 35 has large amount of RAM and it is advisible to allocate 
256 or 512 butes for machine language routines in every program. It 
costs you nothing other than about 10 more seconds of cassette I/O 
time. 


ADDING MACHINE LANGUAGE PROGRAM TO EXISTING BASIC LANGUAGE PROGRAM 
ING UAGE PROGRAM 


The simplest method is to obtain a hard copy of the program; define 
new "Start of User Space" and type in the whole program once more. 
However, this method is a time-consuming job especially when the 
program size is considerable large. 


A second method is to copy the BASIC program to a new location higher 
up in the memory space and then change the appropriate system pointers 
to point to the relocated BASIC language program. 


For example, we can copy the program 256 bytes upward and leave that 
amount of space for machine language program. 





BASIC 
PROGRAM 


MACHINE 


LANGUAGE 
ROUTINES 4400 (HEX) 


SYSTEM 
PARAMETERS | 4000 (HEX) 


ORIGINAL BASIC PROGRAM RELOCATED BASIC PROGRAM 












BASIC 4500 (HEX) 


PROGRAM 






4400 (HEX) 






SYSTEM 
PARAMETERS | 4000 (HEX) 


4.4 System Pointers 7 


The BASIC interpretor keeps FIVE 16-BIT system pointers to 
trace the location of the BASIC language program in the 
memory space. 


4281 4282 Start of User Space in memory 


4283 4284 









4281 is the HIGH byte 
4282 is the LOW byte 







End of User Space in memory 
This value indicate the first 
byte left unused by the user's 
BASIC program 









Program data storage starts at 
this location and extends upward. 





Its value is displayed (in hex- 
idecimal) by typing the 'EOP' 
command 














4283 is the HIGH byte 
4284 is the LOW byte 













End of array .and start of string 





4292 is the HIGH byte 
4293 is the LOW byte 













4292 4293 






4294 4295 of arrays 
4294 is the HIGH byte 
4295 is the LOW byte 
4299 429A End of Variable 


This marks the first free byte 
left unused by the user's program 
and user's data. User can have 
free access to memory lies between 
this pointer and the system stack 
pointer (Register 2 of CPU). 


4.2 Relocation of a BASIC program using utilities available 


from COMX 35 Standard Printer Interface Card 


In the following illustration, a sample program was typed 

in and stored at the default memory location. It was then 
decided that a machine language subroutine was needed. The 
BASIC program was relocated to 256 byte higher in the memory 
and the 5 system pointers was changed accordingly. The 
machine language subroutine was then entered and new lines 
were added to the BASIC language program to call the new 
machine language subroutine. 


The relocation process was illustrated in a stepwise manner 
and explainations were given on each step. 


STEP 1 : LIST the program for reference 


The storage format of a BASIC language line is shown 
below 


HIGH BYTE 


LOW BYTE 
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LOW BYTE 





Line number expressed as 16 bit interger 
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Line length in bytes (exclude the 2 line number byte) 


TOKEN code of the keyword 






Line contents 


The end of program line is marked by a ‘OD' byte 






Line number of next program line 
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List the sample Program for reference 
Find out the values of "End of Progra. 
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STEP 2 : The copy program will copy 256 byte of memory at one time. 
The last copied byte must be 4400(HEX) and hence the source 
and destination address must be multiple of 256 byte. That 
is, the low byte must be equal to FF(HEX) and the last copied 
address will be ??00. 


EXAMPLE 


"End of Data’ pointer value 






Starting Source Address 





In our example, EOD is equal to 44BF(HEX) and source address 
is equal 44FF (HEX) e 


Hence, memory ranging inclusively from 44FF (HEX) to 4400(HEX) 
will be copied. 





The copied memory is dumped for reference. 
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The 'Memory examine and modify' routine is used to change 5 


system pointers to point back to the relocated BASIC program 


The BASIC program has been moved up 256 bytes and hence all 
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Start of User Space (HIGH Byte) 
End of User Space (HIGH Byte) 
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End of array/Start of string (HIGH Byte) 


Start of array (HIGH Byte) 






“TY fad de tad ds ci 
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End of variables (HIGH Byte) 





EOP and EOD is shown for reference 
LIST will shown that the program has been relocated successfully. 


Note : If the user modifies the system pointers to some wrong value, 
LIST may still work but the system will crash on EDITing. 


New lines are then added and they are automatically appended 
to the end of the relocated BASIC program. 


EOP and EOD are automatically incremented as the program grows. 
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